home *** CD-ROM | disk | FTP | other *** search
/ Games of Daze / Infomagic - Games of Daze (Summer 1995) (Disc 1 of 2).iso / x2ftp / msdos / libs / avril20 / read.me < prev    next >
Text File  |  1995-04-10  |  5KB  |  126 lines
  1.  
  2.                                   AVRIL
  3.  
  4. This is release 2.0 of AVRIL, a library for creating virtual reality
  5. applications.
  6.  
  7. Changes since 1.1 include:
  8.     HMD support:
  9.         CyberMaxx (VictorMaxx Technologies)
  10.         i-glasses! (Virtual i/o)
  11.         7th Sense (All-Pro)
  12.     support for CyberWand from InWorld VR
  13.     support for the FifthGlove from 5DT
  14.     stereoscopic viewing
  15.     Gouraud shading
  16.     modular video driver
  17.     modular display driver
  18.  
  19. These changes are detailed in Appendix A of the documentation file.
  20.  
  21. Unfortunately, there are some features that are not fully implemented.
  22.  
  23.     The Gouraud shading has a few flaws (little glitches here and there
  24.     in the shading), and hasn't been exhaustively tested; it's the last
  25.     feature I added before the release.  It's also very slow; using a
  26.     little bit of assembly language here should speed it up considerably,
  27.     but I'll save that for the next release.
  28.  
  29.     Not all the stereo modes are implemented yet.
  30.  
  31.     The horizon code was always broken, so I've temporarily
  32.     disabled it; I hope to completely rewrite it for a future
  33.     release, adding a "stepped" or "layered" horizon; if anyone
  34.     has any code for doing this that they'd like to contribute,
  35.     let me know!
  36.  
  37. The current version of the code is also relatively slow, since I've
  38. converted everything to C (no assembly language at all) and haven't done
  39. any optimization.  This is the final stage before porting to other
  40. platforms; once the ports have been done, I'll be re-optimizing the PC
  41. version and putting assembler into a few time-critical routines (thereby
  42. getting the speed back up).
  43.  
  44. The latest version of this software can always be found on sunee.uwaterloo.ca,
  45. in the pub/avril directory.
  46.  
  47. CONTENTS
  48.  
  49. The contents of this archive are as follows:
  50.  
  51. read.me         this file
  52. av.exe          the world-viewing program
  53. av.c            the source code for av.exe
  54. avril.cfg       the configuration file for av.exe
  55. avril.h         the AVRIL header file
  56. avril.lib       the AVRIL library
  57. avrilkey.h      definitions of keycodes
  58. avrildrv.h      definitions for device driver functions
  59. example1.c      example 1 from the AVRIL tutorial
  60. example2.c      example 2 from the AVRIL tutorial
  61. example3.c      example 3 from the AVRIL tutorial
  62. example4.c      example 4 from the AVRIL tutorial
  63. example5.c      example 5 from the AVRIL tutorial
  64. example6.c      example 6 from the AVRIL tutorial
  65. example6.cfg    the configuration file for example6
  66. example7.c      example 7 from the AVRIL tutorial
  67. shade32.pal     a palette used by example7
  68. input.c         source code for some routines used by all the examples
  69. system.c        source code for some of the system routines
  70. cfg.c           source code for the configuration file parser
  71. drvcyman.c      sample driver source code (for the Logitech Cyberman)
  72. vidsamp.c       sample source code for low-level video driver (mode 0x13)
  73. packet.c        source code for collecting packets of binary data
  74. avriltut.ps     the AVRIL tutorial, in Postscript
  75. avriltut.txt    the AVRIL tutorial, in plain ASCII
  76. avrilref.ps     the AVRIL technical reference manual, in Postscript
  77. avrilref.txt    the AVRIL technical reference manual, in plain ASCII
  78. avrilapp.ps     the AVRIL tech ref appendices manual, in Postscript
  79. avrilapp.txt    the AVRIL tech ref appendices manual, in plain ASCII
  80. asteroid.plg    a PLG file used by example2
  81. colorful.plg    a PLG file used by example3
  82. sample.zip      the data for a sample world
  83.  
  84. USING AV
  85.  
  86. Unzip sample.zip, using the -d option to create a directory for the sample
  87. world.  In other words, type "unzip -d sample".
  88.  
  89. To run AV, just type "av sample.wld".  You can also view individual PLG
  90. files and FIG files using AV.
  91.  
  92. MOVING AROUND
  93.  
  94. Moving around the virtual environment is easy.  The following applies to AV
  95. or any of the example programs (once they've been compiled).
  96.  
  97.          Key                                  Function
  98.  
  99.     up/down arrows                      move forward/backward
  100.     left/right arrows                   turn left/right
  101.     leftshift plus up/down arrows       move up/down
  102.     leftshift plus left/right arrows    move left/right
  103.     rightshift plus up/down arrows      look up/down
  104.     rightshift plus left/right arrows   tilt head left/right
  105.  
  106. OTHER KEYS
  107.  
  108. The following keys perform various functions:
  109.  
  110.     ESC     quit
  111.      f      toggle frame rate display
  112.      c      toggle compass display
  113.      p      toggle position display
  114.      d      toggle display of debugging information
  115.      _      (underscore) toggle horizon off/on
  116.     +,-     zoom in, out
  117.      =      reset zoom
  118.     h,H     adjust hither clipping plane distance by current space step
  119.      w      toggle wireframe mode
  120.   (space)   toggle mouse mode between 6D input and on-screen selection
  121.  
  122. CONTACTING THE AUTHOR
  123.  
  124. My email address is broehl@sunee.uwaterloo.ca; mention AVRIL in the
  125. subject line so I'll know what it's about.
  126.